home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / The World of Computer Software.iso / 23subjct.zip / BF.DOC < prev    next >
Text File  |  1986-07-11  |  10KB  |  280 lines
  1.  
  2.                                   Page 1 of 5
  3.  
  4.                              BF.COM (Version 1.10)
  5.  
  6.  
  7.      This  program  is  an  updated version of the Browse program which is
  8.      floating around on some BBS's.  It is  a  program  to  allow  you  to
  9.      browse  through  a text file, without the ability to change anything.
  10.      It is NOT an editor.
  11.  
  12.      The original author is unknown.  He did a great job on  this  program
  13.      but  there  were some features that I thought needed to be installed,
  14.      and some deleted.  These features are as follows:
  15.  
  16.  
  17.     o  The screen color can be changed.
  18.  
  19.     o  The number of lines to scroll on a page up/dn scroll can
  20.        be changed.
  21.  
  22.     o  The number of spaces to be inserted for a tab character can
  23.        be changed.
  24.  
  25.     o  The option of having a totally flicker free screen was added.
  26.  
  27.     o  The cursor is now invisible while the program is running.
  28.  
  29.     o  The entire screen is not cleared when a one line up or down scroll
  30.        is done.  This makes the one line scroll much faster.
  31.  
  32.     o  The screen will clear and display that the program is "READING FROM
  33.        DISK", when it is getting more data from the file on disk.
  34.  
  35.  
  36.      COMMAND
  37.  
  38.      The command line for the program is as follows:
  39.  
  40.                              BF filename [/W] [/F]
  41.  
  42.  
  43.      This program fully supports sub-directories, so you can include drive
  44.      and path names as part os the file specification.
  45.  
  46.      The /W option is for reading Wordstar files.
  47.  
  48.      The  /F option is for those who have color or graphic adapters.  With
  49.      this option set the screen will be updated very fast, but  with  some
  50.      flicker,  on  some systems.  Without this option set, the screen will
  51.      not be updated as fast but there will be  NO  flicker  at  all.   The
  52.      decision is up to the user whether he wants to trade some flicker for
  53.      for a very fast screen update or would rather have no flicker  and  a
  54.      little  slower screen update.  Try out both options before you make a
  55.      decision, many systems act differently.   The  color  used  has  some
  56.      affect on how much flicker is seen in the /F mode.
  57.  
  58.  
  59.  
  60.  
  61.  
  62.                                   Page 2 of 5
  63.  
  64.                              BF.COM (Version 1.10)
  65.  
  66.  
  67.      The  /F  option will make NO difference if you have a monochrome card
  68.      or the Enhanced Graphics Adapter in your computer.  When this is  the
  69.      case,  the  screen  is  always in the fastest mode and the monochrome
  70.      card or EGA take care of the flicker automatically.
  71.  
  72.  
  73.      The key commands are as follows:
  74.  
  75.          HOME  -  Moves screen to the beginning of the file
  76.           END  -  Moves screen to the end of the file
  77.          PGUP  -  Moves screen up one page at a time
  78.          PGDN  -  Moves screen down one page
  79.              UP ARROW  -  Scrolls screen up one line
  80.        DOWN ARROW  -  Scrolls screen down one line
  81.       RIGHT ARROW  -  Moves screen to the right 8 columns at a time
  82.        LEFT ARROW  -  Moves screen to the left 8 columns at a time
  83.       CTRL-LEFT ARROW  -  Moves screen left to the beginning of the line
  84.         CTRL-PGUP  -  Same as HOME key
  85.         CTRL-PGDN  -  Same as END key
  86.  
  87.           ESC  -  Exit the program
  88.         ALT-D  -  Change display color attribute
  89.         ALT-P  -  Select lines per page scroll
  90.         ALT-T  -  Select number of spaces to insert for a tab character
  91.         ALT-I  -  Display program version information
  92.  
  93.  
  94.      COLOR  (ALT-D)
  95.  
  96.      When  the program is loaded the current screen color is used.  If the
  97.      DOS MODE command was used to specify that the  screen  is  black  and
  98.      white,  or  the monochrome adapter is used, the color will default to
  99.      white characters on a black background.
  100.  
  101.      The  color  option is invoked by typing the ALT key and the D keys at
  102.      the same time.  Repeating the ALT-D command cycles through  a  choice
  103.      of  14  color  patterns,  one of which is the original color when the
  104.      program was loaded, for use with color monitors.
  105.  
  106.      You may change the default color setting, to be used when the program
  107.      is loaded, by following the directions below in the DEFAULTS  section
  108.      of this document.
  109.  
  110.      If the MODE command was used to specify a black and white monitor, or
  111.      the monochrome adapter is installed, the ALT-D command is disabled.
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.                                   Page 3 of 5
  123.  
  124.                              BF.COM (Version 1.10)
  125.  
  126.  
  127.      SCROLL  (ALT-P)
  128.  
  129.      The scroll option is invoked by typing the ALT and the P keys at  the
  130.      same  time.   The top 4 rows of the screen will clear and you will be
  131.      prompted to enter how many lines you would like to have scroll  on  a
  132.      page  up or page down operation.  Typing enter will leave the setting
  133.      at the current value.  To change the value, enter a number between  5
  134.      and  50, then strike enter.  I figured there was no need to have less
  135.      than 5 or greater than 50 lines scroll on a pgup or pgdn operation.
  136.  
  137.      You may change the default  scroll  setting,  to  be  used  when  the
  138.      program  is loaded, by following the directions below in the DEFAULTS
  139.      section of this document.
  140.  
  141.  
  142.      TAB Character Spaces  (ALT-T)
  143.  
  144.      This option is useful when looking at files of structured programming
  145.      languages, such as C and Pascal.
  146.  
  147.      To  choose  the  number  of  spaces  to  be  inserted in place of tab
  148.      characters is done by typing the ALT and T keys  at  the  same  time.
  149.      The  top  4 rows of the screen will clear and you will be prompted to
  150.      enter how many spaces to instert for a tab character.  The  operation
  151.      is  the  same as for the scroll option above.  The value entered must
  152.      be between 2 and 64 spaces inserted for  a  tab  character.   If  the
  153.      value is changed, then the horizontal offset will go back to zero and
  154.      the screen will clear and update.
  155.  
  156.      You may choose the  default  tab  spaces  setting  by  following  the
  157.      directions below in the DEFAULTS section of this document.
  158.  
  159.      Note that this value is also used for the number of columns to scroll
  160.      left or right when the left or right arrows are pressed.
  161.  
  162.  
  163.      DEFAULTS
  164.  
  165.      The  program  can  be modified and saved with the options you select.
  166.      Or it may be renamed so you will run a different  name  depending  on
  167.      the options you want set as the defaults.  The program could be saved
  168.      on different sub-directories also.  With this, the user could  run  a
  169.      program  with different attributes, depending on what kind of file he
  170.      is looking through (i.e.  Pascal, C, or regular text).
  171.  
  172.      If you would like to change the default values for these options;  so
  173.      that when the program is loaded you will not have to change the color
  174.      every time to the color you like for example, you  may  follow  these
  175.      instructions.
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.                                   Page 4 of 5
  183.  
  184.                              BF.COM (Version 1.10)
  185.  
  186.  
  187.      DEFAULTS con't
  188.  
  189.  
  190.      A copy of the DOS DEBUG program is needed to perform this operation.
  191.  
  192.      Using the DEBUG program enter the following from the DOS prompt A>
  193.  
  194.     DEBUG BF.COM
  195.  
  196.     E 108 xx    The color ATTRIBUTE you like (see below)
  197.             Default is zero.
  198.  
  199.     E 10F xx    number of lines to scroll for pgup/pgdn.
  200.             Default is 25 decimal (19 hex).
  201.  
  202.     E 115 xx    number of spaces to insert for a tab character and
  203.             the number of columns to scroll left or right on the
  204.             left or right arrow keys. Default is 8.
  205.  
  206.     E 11B xx    make this byte zero to cause the default mode to
  207.             be the fast mode.
  208.  
  209.              NOTE:  xx has to be a hexadecimal number.
  210.  
  211.     W        This will write the file back to the disk with
  212.             the changes made.
  213.  
  214.     DEBUG will response with, "Writing 0A08 bytes"
  215.  
  216.  
  217.      The attributes (colors) which are included in the program are the
  218.      following:
  219.  
  220.     0F  -  Bright white characters on black
  221.     07  -  White characters on black
  222.     02  -  Green characters on black
  223.     1F  -  Bright white on blue
  224.     17  -  White on blue
  225.     4F  -  Bright white on red
  226.     47  -  White on red
  227.     20  -  Black on green
  228.     30  -  Black on cyan
  229.     71  -  Blue on white
  230.     70  -  Black on white
  231.     06  -  Yellow on black
  232.     0E  -  Bright yellow on black
  233.  
  234.      Any color attribute may be  used.   For  more  information  on  color
  235.      attributes refer to the DOS Technical Reference Manual.
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.                                   Page 5 of 5
  243.  
  244.                              BF.COM (Version 1.10)
  245.  
  246.  
  247.      DISCLAIMER
  248.  
  249.      This  code is released into the public domain with no restrictions as
  250.      to its use.
  251.  
  252.      The author has taken due care in writing this code, and the  code  is
  253.      supplied as is.  The author makes no expressed or implied warranty of
  254.      any kind with regard to this code.  In no event shall the  author  be
  255.      liable  for incidental or consequential damages in connection with or
  256.      arising out of the use of this code.
  257.  
  258.  
  259.      VERSION INFORMATION
  260.  
  261.      Version  1.10  -
  262.  
  263.       o  Fixed  a  minor  bug that kept the screen from changing back from
  264.          the reading data from disk message to the file data.  This  would
  265.          occur  if  the program would have to read more data from the file
  266.          while updateing the screen.  The file is also read  while  moving
  267.          foreward in the buffer to the next page or line before it goes to
  268.          update the screen, but this caused no problem.
  269.  
  270.       o  When the ANSI driver is  installed,  and  the  default  color  is
  271.          altered  by  the user, the reading data from disk message was not
  272.          the correct color.  It would be the original color  as  when  the
  273.          program  was  called  instead  of  the default color set into the
  274.          program with the DEBUG program.  This is now fixed.
  275.  
  276.       o  Added the option of changing the number of spaces inserted for  a
  277.          tab character (ALT-T command).
  278.  
  279.       o  Fast mode default can now be set.
  280.